###User Defined Function###
_Excel_PictureAdd

###Description###
Fügt ein Bild in das angegebene Arbeitsbuch und die Arbeitsseite

###Syntax###
#include <Excel.au3>
_Excel_PictureAdd ( $oWorkbook, $vWorksheet, $sFile, $vRangeOrLeft [, $iTop = Default [, $iWidth = Default [, $iHeight = Default [, $bKeepRatio = True]]]] )

###Parameters###
@@ParamTable@@
$oWorkbook
	Excel Arbeitsbuch Objekt
$vWorksheet
	Name, index oder Arbeitsbuch Objekt in das geschrieben werden soll. Wenn das Schlüsselwort Default gesetzt ist, wird die aktive Seite genutzt
$sFile
	Voller Pfad zur Bilddatei, welches hinzugefügt werden soll
$vRangeOrLeft
	Entweder ein A1 Bereich, ein Bereichs Objekt oder eine Zahl, welche die Linke Position der oberen, linken Ecke des Bildes festlegt
$iTop
	[optional] Wenn $vRangeOrLeft ein Integer ist, dann ist $iTop die obere Position der oberen, linken Ecke des Bildes
$iWidth
	[optional] Wenn angegeben, setzt es die Breite des Bildes. Wenn nicht angegeben, wird die Breite automatisch ermittelt (Standart = automatisch)
$iHeight
	[optional] Wenn angegeben, setzt es die Höhe des Bildes. Wenn nicht angegeben, wird die Höhe automatisch ermittelt (Standart = automatisch)
$bKeepRatio
	[optional] Wird nur genutzt, wenn die $vRangeOrLeft ein Mehrfachzellen-Bereich ist (Standart = True)
		True wird das Imageformat in den Grenzen der $vRangeOrLeft erhalten.
		Flase wird die $vRangeOrLeft füllen, unabhängig vom Bildformat
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Ein Formobjekt, dass das neue Bild darstellt
Failure:	0 und setzt @error.
@error:	1 - $oWorkbook ist kein Objekt oder kein Arbeitsbuch Objekt
	2 - $vWorksheet Name oder Index ist falsch oder $vWorksheet ist kein Arbeitsseiten Objekt. @extended ist gesetzt auf den COM error code
	3 - $vRangeOrLeft ist falsch. @extended ist auf den COM error code gesetzt
	4 - Ein Fehler trat beim hinzufügen des Bildes auf. @extended ist auf den COM error code gesetzt
	5 - $sFile existiert nicht
@@End@@

###Remarks###
Wenn $vRangeOrLeft ein Bereich mit mehreren Zellen ist, wird $iWidth und $iHeight ignoriert (um Breite/Höhe nicht basierend auf der Bereichs Breite/Höhe anzugeben, gibt eine einzelne Zelle in $vRangeOrLeft an)

Wenn nur Breite oder Höhe angegeben ist, wird die andere (auf Standart gesetzt) skaliert um das Format des Originalbildes beizubehalten.
Wenn beide, Breite und Höhe, angegeben sind, wird das Bild die angegebenen Werte ungeachtet des originalen Formates nutzen.
Wenn weder Breite, noch Höhe angegeben sind, wird das Bild automatisch auf die größe des Original Bildes skaliert.

$bKeepRatio wird ignoriert, wenn keine Range über mehrere Zellen angegeben wurde (siehe Parameter für Details).

###Related###
Keine.

###Example###
@@IncludeExample@@
